home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / g_man / cat3 / ftn / sboxf.z / sboxf
Encoding:
Text File  |  1998-10-20  |  4.5 KB  |  133 lines
  1.  
  2.  
  3.  
  4. ssssbbbbooooxxxxffff((((3333GGGG))))                                                            ssssbbbbooooxxxxffff((((3333GGGG))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      ssssbbbbooooxxxxffff,,,, ssssbbbbooooxxxxffffiiii,,,, ssssbbbbooooxxxxffffssss - draw a filled screen-aligned rectangle
  10.  
  11. FFFFOOOORRRRTTTTRRRRAAAANNNN 77777777 SSSSPPPPEEEECCCCIIIIFFFFIIIICCCCAAAATTTTIIIIOOOONNNN
  12.      ssssuuuubbbbrrrroooouuuuttttiiiinnnneeee ssssbbbbooooxxxxffff((((xxxx1111,,,, yyyy1111,,,, xxxx2222,,,, yyyy2222))))
  13.      rrrreeeeaaaallll xxxx1111,,,, yyyy1111,,,, xxxx2222,,,, yyyy2222
  14.  
  15.      ssssuuuubbbbrrrroooouuuuttttiiiinnnneeee ssssbbbbooooxxxxffffiiii((((xxxx1111,,,, yyyy1111,,,, xxxx2222,,,, yyyy2222))))
  16.      iiiinnnntttteeeeggggeeeerrrr****4444 xxxx1111,,,, yyyy1111,,,, xxxx2222,,,, yyyy2222
  17.  
  18.      ssssuuuubbbbrrrroooouuuuttttiiiinnnneeee ssssbbbbooooxxxxffffssss((((xxxx1111,,,, yyyy1111,,,, xxxx2222,,,, yyyy2222))))
  19.      iiiinnnntttteeeeggggeeeerrrr****2222 xxxx1111,,,, yyyy1111,,,, xxxx2222,,,, yyyy2222
  20.  
  21.      All of the above functions are functionally the same except for the type
  22.      declarations of the parameters.
  23.  
  24. PPPPAAAARRRRAAAAMMMMEEEETTTTEEEERRRRSSSS
  25.      _x_1   expects the _x coordinate of a corner of the filled box.
  26.  
  27.      _y_1   expects the _y coordinate of a corner of the filled box.
  28.  
  29.      _x_2   expects the _x coordinate of the opposite corner of the filled box.
  30.  
  31.      _y_2   expects the _y coordinate of the opposite corner of the filled box.
  32.  
  33. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  34.      ssssbbbbooooxxxxffff draws a filled, two-dimensional, screen-aligned rectangle.  The
  35.      rectangle is drawn as a single polygon, and therefore inherits many
  36.      properties that affect the drawing of polygons.  These include the
  37.      current color, writemask, fill pattern, and subpixel mode.
  38.  
  39.      The sides of the rectangle will be parallel to the screen _x and _y axes.
  40.      This rectangle cannot be rotated.  The _z coordinate is set to zero.
  41.  
  42.      When you use ssssbbbbooooxxxxffff, you must not use alpha blending, backfacing or
  43.      frontfacing, depthcueing, fog, gouraud shading, lighting, polygon
  44.      antialiasing, screen subdivision, stenciling, texture mapping, or z-
  45.      buffering.  ppppoooollllyyyymmmmoooo must be set to PYMFIL.
  46.  
  47.      ssssbbbbooooxxxxffff may be faster than rrrreeeeccccttttffff on some machines.  Use ssssbbbbooooxxxxffff when you need
  48.      to draw a large number of screen-aligned rectangles.
  49.  
  50.      After ssssbbbbooooxxxxffff executes, the graphics position is undefined.
  51.  
  52. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  53.      backfa, bgnpol, blendf, depthc, frontf, glcomp, lmbind, polymo, polysm,
  54.      rectf, scrsub, setpat, shadem, stenci, subpix, texbin, zbuffe
  55.  
  56. NNNNOOOOTTTTEEEE
  57.      By default ssssbbbbooooxxxxffff draws a polygon using the old-style scan conversion
  58.      algorithm, rather than the point sampling algorithm used by bbbbggggnnnnppppoooollll and
  59.      eeeennnnddddppppoooollll.  Point sampling is prefered over old-style scan conversion
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. ssssbbbbooooxxxxffff((((3333GGGG))))                                                            ssssbbbbooooxxxxffff((((3333GGGG))))
  71.  
  72.  
  73.  
  74.      because it has higher performance.  Call ggggllllccccoooommmmpppp((((GGGGLLLLCCCCOOOOLLLLDDDD,,,,0000)))) to enable point
  75.      sampling of polygons generated by ssssbbbbooooxxxxffff.
  76.  
  77.  
  78.  
  79.  
  80.  
  81.  
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.